home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / system / bywhen10.zip / BYWHEN.DOC next >
Text File  |  1995-01-09  |  9KB  |  247 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                                     W.S.B. COMMUNICATIONS
  20. ∙∙∙ ∙∙∙ ∙∙∙ ──────────────────────────────────────────────────────────────>
  21.  
  22.                       BYWHEN (c) 1994 William Burlew
  23.                            Unregistered Version
  24.                             All Rights Reserved                                
  25.  
  26.                                                                          [i].
  27.  ────────────────────────────────────────────────────────────────────────────
  28.  
  29.  
  30.  
  31.                                    CONTENTS
  32.  
  33.   Copyright Notice ..................................................... [ 1]
  34.   Program Description(s) ............................................... [ 2]
  35.   Examples ............................................................. [ 3]
  36.   Warnings ............................................................. [ 4]
  37.   Registration ......................................................... [ 5]
  38.   E-Mail Addresses ..................................................... [ 6]
  39.   Thanks ............................................................... [ 6]
  40.  
  41.  
  42.  
  43.               *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *               
  44.  
  45.                                                                          [1].
  46.  ────────────────────────────────────────────────────────────────────────────
  47.  
  48.  
  49.  {- Copyright Notice -}
  50.  
  51.    The program, BYWHEN.EXE is protected by the United States copyright law.
  52.    All rights are reserved.
  53.  
  54.  
  55.  {- Disclaimer -}
  56.  
  57.    For the disclaimer of warranty for the above mentioned programs, they
  58.    are distributed as is.  William Burlew, (hereafter referred to as
  59.    'the author') disclaims all warranties, expressed or implied, including
  60.    without limitation, any warranties of merchantability and/or fitness for a
  61.    particular purpose.
  62.  
  63.    The author shall not be liable for any damages, whether direct, indirect,
  64.    special, or consequential arising from a failure of these programs to
  65.    operate in the manner desired by the user.  The author shall not be liable
  66.    for any damage to data or property which may be caused directly or
  67.    indirectly by use of these program(s).
  68.  
  69.  
  70.  {- Acknowledgements -}
  71.  
  72.   ■ IBM is a registered trademark of International Business Machines.
  73.    ■ MS-DOS is a registered trademark of Microsoft Corporation.
  74.    ■ Novell is a registered trademark of Novell, Inc.
  75.    ■ CompuServe is a registered trademark of CompuServe Information Services,
  76.      Inc.
  77.  
  78.    * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *    
  79.  
  80.   
  81.                                                                          [2].
  82.  ────────────────────────────────────────────────────────────────────────────
  83.  
  84.  
  85.  {- DESCRIPTION -}
  86.  
  87.  
  88.     BYWHEN is a DOS based program and is not a TSR.  Program requires DOS
  89.     v3.0 or greater, IBM compatible 286 CPU or higher.
  90.  
  91.     BYWHEN was originally written to execute our sort programs on dedicated
  92.     machines at the research institute where I manage their Novell network.
  93.     My director wanted a simple program to execute programs via command line
  94.     options and did not want another TSR on our system.  Yes, we do have the
  95.     luxury of multiple dedicated machines which some MIS departments may
  96.     not.  Thus, BYWHEN may not be suitable for them.  Future updates can be
  97.     coded as a TSR if there is a demand.
  98.  
  99.     A program to execute other programs at a given date and time.  Parameters
  100.     are passed from the command line.  BYWHEN will execute files with -
  101.     .bat, .com, .exe -  file extensions on the date and time you pass to it.
  102.     Options needed for your program that you pass to BYWHEN are also accepted.
  103.  
  104.     BYWHEN has been tested on Novell v3.11 systems and under MS Windows v3.1.  
  105.  
  106.  
  107.                                                                          [3].
  108.  ────────────────────────────────────────────────────────────────────────────
  109.  
  110.  
  111.  {- HELP -}
  112.  
  113.  
  114. Usage:
  115.   bywhen [d:\]filename.ext /t:hh:mm:ss [options]
  116.  
  117.   where the following options are
  118.  
  119.   d:\              program's valid path
  120.   filename.ext     program to execute,  i.e.,  - .com  .bat  .exe  -
  121.                       extension must be given.
  122.   /p:opts          arguments to pass to your executable program.
  123.   /d:mm/dd/yyyy    date to execute program on. assumes current system date
  124.                       if not specified.
  125.   /t:hh:mm:ss      time to execute program on in military format.
  126.   /m:owner         name of machine's owner for blinking warning message
  127.                      may be up to 20 characters long.
  128.                      automatically sets the [/w] option.
  129.   /w               turns on default blinking warning message if /m:
  130.                      is not specified.
  131.  
  132.   Do not merge any options:  i.e., "/p:??/d:mm/dd/yyyy" is illegal.
  133.  
  134.  
  135.  {- EXAMPLES -}
  136.  
  137.     Only two parameters are required to execute BYWHEN, filename & time.
  138.  
  139.     ex1.   bywhen filename.ext /t:08:10:00
  140.  
  141.       executes filename.ext at 8:10am on the current system date with no
  142.       warning message displayed.
  143.  
  144.     ex2.   bywhen c:\bc31\bin\make.exe /p:-fmakefile /t:23:00:00 /d:10/24/1994
  145.  
  146.       executes make to compile makefile at 11:00pm on 10/24/1994
  147.  
  148.     ex3.   bywhen filename.ext /t:08:10:00 /w
  149.  
  150.       executes filename.ext at 8:10am on the current system date with the
  151.       default blinking warning message displayed, i.e.,
  152.  
  153.          "Please Do Not Touch This Machine.  Check With Owner First!."
  154.  
  155.     ex4.   bywhen filename.ext /p:-a-b /t:08:10:00 /d:10/24/1994 /m:Bill
  156.  
  157.       executes filename.ext with filename.ext options -a-b at 8:10am on date
  158.       10/24/1994 with the blinking warning message displayed, i.e.,
  159.  
  160.          "Please Do Not Touch This Machine.  Check With Bill First!."
  161.  
  162.  
  163.     BYWHEN will search your path for the first occurrence of the file name
  164.     you pass to it.  If it cannot be found then an error message is displayed
  165.     "file not found".  If this error is returned you should provide the
  166.     complete valid path with file name.
  167.     If you have more than one file with the same name on your system you
  168.     should enter the complete path and file name.
  169.  
  170.     To cancel BYWHEN after it sets itself up press <ctrl-end>.  If you have
  171.     remapped this key combination you will need to reset it in order to
  172.     cancel BYWHEN.  There is a 1.5 second delay after pressing <ctrl-end>
  173.     in order for BYWHEN to perform some internal cleanup duties.              
  174.  
  175.  
  176.                                                                          [4].
  177.  ────────────────────────────────────────────────────────────────────────────
  178.  
  179.  {- WARNINGS -}
  180.  
  181.     Do NOT attempt to execute a TSR with BYWHEN.  Due to the memory
  182.     allocation scheme used, BYWHEN, in all likelihood, will return an error
  183.     message if it attempts to load a TSR.
  184.  
  185.     To limit some code, there is no check to see if the date you pass to
  186.     BYWHEN is in fact less than the current system date.
  187.     Thus BYWHEN will sit there for an indefinite amount of time never to be
  188.     able to execute your program.
  189.  
  190.  
  191.  {- INTRINSIC DOS COMMANDS -}
  192.  
  193.      BYWHEN will NOT execute intrinsic DOS commands if passed to it.
  194.      BYWHEN searches your path to validate that the passed program
  195.      name exists so an error is returned if an intrinsic command is
  196.      passed.
  197.  
  198.      Intrinsic DOS commands should be coded in a batch file and the
  199.      batch file name passed to BYWHEN along with other valid options.
  200.      See BYWHEN1.BAT & BYWHEN2.BAT for some examples.                         
  201.  
  202.  
  203.                                                                          [5].
  204.  ────────────────────────────────────────────────────────────────────────────
  205.  
  206.  {- COMMERCIALWARE/REGISTRATION -}
  207.  
  208.   The only difference between the unregistered & registered version is that
  209.   with the registered version the BYWHEN info screen randomly dances around
  210.   the screen.  This was coded for when the actual execution of your program
  211.   may not be until days/weeks have passed.
  212.  
  213.   Please see the REGISTRATION.DOC.                                             
  214.  
  215.  
  216.                                                                          [6].
  217.  ────────────────────────────────────────────────────────────────────────────
  218.  
  219.   Update development notes
  220.  
  221.   -None-                                                bv1.00 10/24/94 {wsb}
  222.   Inline time slice coded                               bv1.01 11/05/94 {wsb}
  223.   Trashing of cursor on return from child               bv1.01 11/08/94 {wsb}
  224.   Loop logic (Doskey & Idle)                            bv1.01 11/09/94 {wsb}
  225.  
  226.  
  227.   Suggestions welcomed.  EMail address...
  228.  
  229.   Internet
  230.   73053.3202@compuserve.com
  231.  
  232.   CIS
  233.   73053,3202
  234.   ----------
  235.  
  236.   Extended Thanks:
  237.  
  238.   PythagorasPLJ
  239.     @UCBerkeley for original idea...polling suggestions and
  240.     beta testing.
  241.   Berkeley Integration Group (B.I.G)
  242.     beta testing and their expert advice on Novell.
  243.   Kim K.
  244.     advice on time slice inline code while in MS Windows.
  245.   Kevin Lee
  246.     @University of Nevada-Reno   Center for Applied Research
  247.